home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / d / dmsv2.31.lha / DMS v2.31 / DMS.doc < prev    next >
Text File  |  1996-01-01  |  15KB  |  468 lines
  1.  
  2.  
  3. FILE: DMS.doc - AmigaDOS version 2.31 documentation  - 96/01/02
  4.  
  5.  
  6.  
  7. *****************************************************************************
  8.  
  9.                           The DISK-Masher
  10.                    Copyright (c) 1984-1996 Pancom
  11.  
  12. *****************************************************************************
  13.  
  14.  
  15.  
  16. What is it?
  17.  
  18.     The DISK-Masher (DMS) is a utility that allows users to compress and
  19. archive floppy disks.  Version 2.31 requires at least 512k of memory, and
  20. AmigaDOS version 1.2 or later.
  21.  
  22. Why a disk archiver?
  23.  
  24.     Many programs are available for archiving individual files and do a
  25. relatively good job.  However DMS was created for the purpose of archiving
  26. whole disks.  It is useful for archiving non-filing system disks which cannot
  27. be done with standard file archivers, sending distribution disks, archiving
  28. library collections, and many other uses.  DMS takes much less time to
  29. put a disk back together than with a file archiver and is less wear and
  30. tear on your disk drives.
  31.  
  32. Why not use other disk archivers?
  33.  
  34.     DMS has been tested against every other similar type programs and will
  35. provide faster execution, greater compression, more support features, and
  36. continuing user support.  Once you try DMS you won't be satisfied with
  37. anything else.  Among other things DMS provides:
  38.  
  39.     - Highly optimized compression routines offerring the utmost
  40.       in speed and compression.  4 different routines to choose from
  41.       to satisfy your needs.
  42.  
  43.     - The ability to read and write to or from any AmigaDOS device conforming
  44.       to the standard 80 tracks , 512 bytes per block , 11 blocks per track,
  45.       2 sides, Ex: DF0:, DF1:, RAD:, etc.
  46.  
  47.     - Extended Virus checking of the boot blocks.  Other disk archivers
  48.       just show the boot block and do not check for viruses, this is
  49.       extremely stupid, most viruses do not come out and say "Look here,
  50.       I'm a virus!".  Without actually checking the boot block you're
  51.       opening up a can of worms.  Therefore DMS currently checks for over
  52.       60 different viruses and custom boot blocks and can automatically
  53.       install the disk.  It is still Important that users monitor their
  54.       system periodically with a virus checker as there are many types
  55.       of viruses.
  56.  
  57.     - Data Security.  DMS has the option to encrypt archives with a user
  58.       selected password for security.
  59.  
  60.     - Also included are a DMS version for 68020 machines or higher. But
  61.       the archive is still useable for the plain x.000 DMS version
  62.  
  63.  
  64.  
  65. *****************************************************************************
  66.  
  67.                     Command Line Options and Usage
  68.  
  69.   The general format for a DMS command is:
  70.  
  71.   DMS command file[.DMS] [OPTIONS ...]
  72.  
  73.   Everything in braces [] is optional. Everything else is required.
  74.  
  75.   file[.DMS] is a user specified filename.  The .DMS ending will
  76.   automatically be appended to the filename if you do not include it.
  77.   This is done to avoid confusion with other archiver formats.
  78.  
  79.  
  80. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  81.  
  82. 1.) READ
  83.  
  84.   This command will read and compress a disk.  The basic usage for this
  85.   command is:
  86.  
  87.   DMS Read file[.DMS] [FROM Dev:] [TEXT filetext] [CMODE mode] [LOW lowtrack]
  88.                       [HIGH hightrack] [NOVAL] [NOZERO] [ENCRYPT password]
  89.  
  90.   file[.DMS]
  91.  
  92.   - the output file which will contain the archived disk.
  93.  
  94. OPTIONS:
  95.  
  96.   FROM Dev:
  97.  
  98.   - Will read the disk from a different device.  The default device is DF0:
  99.     (internal drive).  You may choose any device as long as it has 80 tracks,
  100.     2 sides, 11 sectors/track, and 512 bytes per sector.
  101.     Examples: DF0:, DF1:, DF2:, DF3:, RAD:, FM0:, FF0:, etc.
  102.  
  103.   TEXT filetext
  104.  
  105.   - Causes DMS to read in the file 'filetext' and add it to the archive.
  106.     When the archive is extracted the text will be displayed before writing
  107.     the disk.  This is useful for identifying disks or giving other
  108.     information about the archive.
  109.  
  110.   CMODE mode
  111.  
  112.   - Chooses the compression mode used.  Mode is either NONE, HEAVY1, HEAVY2,
  113.     or BEST
  114.  
  115.     The default mode is BEST
  116.  
  117.     Available modes are:
  118.  
  119.       NONE   - No Compression is performed (Straight Read).
  120.       HEAVY1 - Heavy compression, good speed/compression ratio.
  121.       HEAVY2 - Best available compression.  Only available with >1meg ram.
  122.       BEST   - Chooses Best compression method for available memory.
  123.  
  124.   LOW lowtrack
  125.  
  126.   - Specifies the starting track to read from.  The default is track 0.
  127.     Lowtrack must be a value from 0 to 79.
  128.  
  129.   HIGH hightrack
  130.  
  131.   - Specifies the ending track to stop at.  The default is track 79.
  132.     Hightrack must be a value from 0 to 79.
  133.  
  134.   NOVAL
  135.  
  136.   - Stops DMS from inhibiting the disk validator when reading the disk.
  137.  
  138.   NOZERO
  139.  
  140.   - Normally DMS will read the AmigaDOS bitmap from the disk and archive
  141.     only sectors which are being used.  If the disk is a non-filing system
  142.     disk or has a bad bitmap, DMS will automatically archive the whole disk.
  143.     In EXTREME cases DMS will make a wrong assumption about the type of
  144.     disk it is archiving. NOZERO will cause DMS to archive the whole disk
  145.     totally ignoring the disk bitmap.  Generally you will rarely if ever
  146.     have to use this option.
  147.  
  148.   ENCRPYT password
  149.  
  150.   - Causes DMS to encrypt the input from the disk using the password
  151.     supplied. 'password' is any alphanumeric word you desire.
  152.     Examples: Joe, Fred, ABC1234, ONLY-FOR-ME, etc.
  153.  
  154. EXAMPLES:
  155.  
  156.   DMS read disk1
  157.  
  158.   - Will compress a disk from drive DF0: using the default compression mode
  159.     and store the results in the file 'disk1.DMS'
  160.  
  161.   DMS read stuff.DMS lowtrack 20
  162.  
  163.   - Will compress only tracks 20 to 79 into file 'stuff.DMS'
  164.  
  165.   DMS read stuff lowtrack 40 hightrack 40
  166.  
  167.   - Will compress only track 40 into file 'stuff.DMS'
  168.  
  169.   DMS read stuff from df1: cmode heavy1 noval nozero text RAM:intro
  170.  
  171.   - Will compress a disk from drive DF1: using compression mode HEAVY1, not
  172.     inhibiting the disk validator, not using the disk bitmap and adding
  173.     the text from file 'RAM:intro' to the file 'stuff.DMS'
  174.  
  175.   DMS read stuff.DMS from RAD: encrypt JOESTUFF1
  176.  
  177.   - Will compress a disk from ram drive RAD: and encrypting the output
  178.     with the password 'JOESTUFF1' to file 'stuff.DMS'
  179.  
  180.   DMS read stuff.DMS text CON:0/0/640/200/window
  181.  
  182.   - Will compress a disk and allow you to quickly add text to the archive.
  183.     A console window will open up and you can then type any text you
  184.     want.  To finish type CTRL \ to close the window and continue.
  185.  
  186.  
  187. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  188.  
  189. 2.) WRITE
  190.  
  191.   This command will uncompress and write a disk.  The basic usage for this
  192.   command is:
  193.  
  194.   DMS Write file[.DMS],,, [TO Dev:] [LOW lowtrack] [HIGH hightrack]
  195.                           [NOVAL] [NOTEXT] [NOPAUSE] [DECRYPT password]
  196.  
  197.   file[.DMS],,,
  198.  
  199.   - One or more input files to be extracted.  Standard AmigaDOS wildcards
  200.     are supported.
  201.  
  202. OPTIONS:
  203.  
  204.   TO Dev:
  205.  
  206.   - Will write the output to device Dev: (the default is drive DF0:)
  207.     The device must follows the same rules as in the READ command.
  208.  
  209.   LOW lowtrack
  210.  
  211.   - Specifies the starting track to write from.  Tracks before lowtrack
  212.     will be ignored.  Default is track 0
  213.  
  214.   HIGH hightrack
  215.  
  216.   - Specifies the ending track to write from.  Tracks after hightrack
  217.     will be ignored.  Default is track 79
  218.  
  219.   NOVAL
  220.  
  221.   - Stops DMS from inhibiting the disk validator when writing a disk.
  222.  
  223.   NOTEXT
  224.  
  225.   - Causes DMS to ignore any text to be displayed from the archive.
  226.  
  227.   NOPAUSE
  228.  
  229.   - Stops DMS from pausing after displaying any text from the archive.
  230.  
  231.   DECRPYT password
  232.  
  233.   - Causes DMS to decrypt the archive with the password 'password'.
  234.     This is only used if the archive was previously encrypted.  'password'
  235.     must be the EXACT same one used when encrypting the file otherwise
  236.     the archive will not be processed correctly.
  237.  
  238. EXAMPLES:
  239.  
  240.   DMS write stuff
  241.  
  242.   - Will extract the archive stuff.DMS to drive DF0:
  243.  
  244.   DMS write part1 part2.dms TO DF2: NOTEXT
  245.  
  246.   - Will extract the archives part1.DMS and part2.DMS to drive DF2: ,
  247.     ignoring any banner text in the archives
  248.  
  249.  
  250. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  251.  
  252. 3.) REPACK
  253.  
  254.   This command allows you to recompress an older DMS archive.  It can also
  255.   be used as a simple split utility.  The basic usage for this
  256.   command is:
  257.  
  258.   DMS Repack file[.DMS] [TO file2[.DMS]] [LOW lowtrack] [HIGH hightrack]
  259.                         [CMODE mode]
  260.  
  261.   file[.DMS]
  262.  
  263.   - The input file to be recompressed.
  264.  
  265. OPTIONS:
  266.  
  267.   TO file2[.DMS]
  268.  
  269.   - Causes DMS to store the results in file2.DMS , otherwise the results
  270.     are automatically stored in a file TEMP.DMS
  271.  
  272.   LOW lowtrack
  273.  
  274.   - Specifies lowtrack to start recompression.  Tracks before lowtrack
  275.     will be ignored.  Default is track 0.
  276.  
  277.   HIGH hightrack
  278.  
  279.   - Specifies hightrack to end recompression.  Tracks after hightrack
  280.     will be ignored.  Default is track 79.
  281.  
  282.   CMODE mode
  283.  
  284.   - Chooses the compression mode to use.  Same as in the READ command.
  285.  
  286. EXAMPLES:
  287.  
  288.   DMS repack stuff low 20 high 40 cmode NONE
  289.  
  290.   - Will extract tracks 20 through 40 from the archive stuff.DMS ,
  291.     recompress them using no compression and store the  results
  292.     in the file TEMP.DMS .
  293.  
  294.   DMS repack old.dms TO new.dms
  295.  
  296.   - Will recompress the archive old.DMS using the default compression mode
  297.     and store the results in the file new.DMS
  298.  
  299.  
  300. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  301.  
  302. 4.) VIEW
  303.  
  304.   This command will view information about a DMS archive.  The basic usage
  305.   for this command is:
  306.  
  307.   DMS View file[.DMS],,, [FULL]
  308.  
  309.   file[.DMS],,,
  310.  
  311.   - One or more input files to be viewed.  Standard AmigaDOS wildcards
  312.     are supported.
  313.  
  314. OPTIONS:
  315.  
  316.   FULL
  317.  
  318.   - Causes DMS to display information about every track in the archive.
  319.     Otherwise only the information header will be displayed.
  320.  
  321. EXAMPLES:
  322.  
  323.   DMS view file1 part#? full
  324.  
  325.   - Will display full information about the archives file1.DMS and
  326.     the files part#?.DMS
  327.  
  328.  
  329. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  330.  
  331. 5.) TEST
  332.  
  333.   This command will test the integrity of a DMS archive.  The basic usage
  334.   for this command is:
  335.  
  336.   DMS Test file[.DMS],,,
  337.  
  338.   file[.DMS],,,
  339.  
  340.   - One or more input files to be tested.  Standard AmigaDOS wildcards
  341.     are supported.
  342.  
  343. EXAMPLES:
  344.  
  345.   DMS test file1 part#?
  346.  
  347.   - Will test the archives file1.DMS and the files part#?.DMS
  348.  
  349.  
  350. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  351.  
  352. 6.) TEXT
  353.  
  354.   This command will display any banner text in a DMS archive.  This is
  355.   used to quickly find out information about an archive without having
  356.   to extract it.  The basic usage for this command is:
  357.  
  358.   DMS Text file[.DMS],,,
  359.  
  360.   file[.DMS],,,
  361.  
  362.   - One or more input files to display text.  Standard AmigaDOS wildcards
  363.     are supported.
  364.  
  365. EXAMPLES:
  366.  
  367.   DMS text file1 part#?
  368.  
  369.   - Will display any banner text from the archives file1.DMS and the files
  370.     part#?.DMS
  371.  
  372. *****************************************************************************
  373.  
  374.                        General Information
  375.  
  376.     DMS has been over a year in the making,  the compression routines
  377. are proprietary and we have taken great care to make sure they are the
  378. very best. There is no other program even close to DMS as far as versatility,
  379. performance, and ease of use.  We urge users to register with us so that we
  380. continue to provide the best and continuing support of the product.
  381.  
  382.     This program is NOT Shareware or Public Domain, it is Copyright 1989-91
  383. by SDS Software.  We have taken a different approach in distributing this
  384. program than most people.  There will always be a version of DMS available
  385. to the general public free of charge.  However, we are offerring as an
  386. incentive to register, many other programs that will not be available to
  387. the general public.  We feel that you should get what you pay for and pay
  388. for what you use.  Therefore if you seldom use DMS then the public version
  389. is fine for you and we thank you for using it.  If you use DMS on a regular
  390. basis you are asked to register with SDS Software.  Registering will enable
  391. you to receive future updates and other programs not available to the
  392. general public.  Updates will be provided to users on a first-come,
  393. first-serve basis before public releases.  Please make sure that this program
  394. remains the very best by registering with us.
  395.  
  396.     There are 2 levels of registration to choose from:
  397.  
  398.     Regular:
  399.     -------
  400.  
  401.         For $30 you will be mailed the latest versions of DMS on disk,
  402.         and will also receive:
  403.  
  404.         DMSWin - an Intuition version of DMS with full windowing, gadgets
  405.                  and graphical display.
  406.  
  407.         and other Public Domain SDS Software programs.
  408.  
  409.     Professional:
  410.     ------------
  411.  
  412.         For $50 you will receive the same privileges as above but will also
  413.         receive:
  414.  
  415.         Convert - a Warp-to-DMS converter to convert old .WRP files to the
  416.                   new .DMS format.
  417.  
  418.         ViewDMS - a small utility to view the contents of a DMS archive.
  419.  
  420.         TestDMS - a small utility to test the contents of a DMS archive.
  421.  
  422.         Convert.EXE - MS-DOS versions of the above programs. for people
  423.         ViewDMS.EXE   storing files on MS-DOS machines.
  424.         TestDMS.EXE
  425.  
  426.         You will also receive free updates for a year, and any other DMS
  427.         related programs that are developed or received by SDS Software.
  428.  
  429.     Send a Check or Money Order for the amount of registration you choose,
  430. along with your full name, address, phone number, and computer configuration
  431. to:
  432.  
  433.     Pancom Software
  434.     Suite 126
  435.     4885-A Mcknight Rd.
  436.     Pittsburgh, PA  15237
  437.  
  438.     It is our sincere hope that we can continue to service the Amiga
  439. community with new and innovative programs.  Please allow us to do so by
  440. supporting our products which you use.  Thank you.
  441.  
  442.     If you have any suggestions, complaints, questions, or bug reports,
  443. please write to the above address and be sure to include your full name,
  444. address, phone number, and computer configuration.  For any correspondance
  445. requiring a reply, please included a SASE.
  446.  
  447.     The DISK-Masher (DMS) is Copyright (c) 1989-1991 by SDS Software.
  448. It is NOT Public Domain.  The CLI/Shell GENERIC version is freely
  449. distributable provided the following rules:
  450.  
  451.     1.  No charge excepting reasonable media costs may be charged.
  452.  
  453.     2.  The program and documentation may not be modified in any way.
  454.  
  455.     3.  Only the self-extracting archive DMSxxx.EXE may be distributed
  456.  
  457.     SDS Software will be in no way liable for damages, incidental, or
  458. consequential, arising from the use or misuse of The DISK-Masher or for
  459. any other claim by any other party.  Use this program at your own risk.
  460. No warranty is given, either expressed or implied.  Terms of registration
  461. are subject to change without notice.
  462.  
  463. *****************************************************************************
  464.  
  465.     Amiga and AmigaDOS are trademarks of Commodore-Amiga, Inc.
  466.     MS-DOS is a trademark of Microsoft.
  467.     DaCore is a trademark of -[CSD]- ((!SBO))
  468.